home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 17 / CU Amiga Magazine's Super CD-ROM 17 (1997)(EMAP Images)(GB)[!][issue 1997-12].iso / CUCD / Programming / Gui4Cli / Docs / 3.0_Changes < prev    next >
Encoding:
Text File  |  1980-01-03  |  9.2 KB  |  233 lines
  1.  
  2.  
  3.                
  4.            Gui4Cli VERSION 3.0 - April 1997 - Changes
  5. -----------------------------------------------------
  6.  
  7. ************ VISUAL EDITING :
  8. -------------------------------
  9.  
  10. - You can now visually edit guis with CONTROL-mouseclick.
  11.   Gadgets/Graphics/Icons etc can be moved, resized, cloned into
  12.   other windows, deleted and the gui can be saved out.
  13.   Read all about it.. 
  14.  
  15.  
  16. ************ LISTVIEWS :
  17. --------------------------------
  18.  
  19. - Handling Listviews has changed and so have the relevant listview
  20.   commands. Listviews are now handled by CURRENT LISTVIEW and 
  21.   CURRENT LINE of the current listview.
  22.  
  23.   The listview commands no longer have the GuiFile GadID arguments
  24.   but instead act on the CURRENT listview and it's CURRENT line. 
  25.  
  26. - LVUSE GuiFile GadID - will make the specified listview the CURRENT
  27.   one and all the LV internal vars will reflect this. When the user
  28.   clicks on a listview, that LV is automatically made the CURRENT LV.
  29.   This command is to allow you to specify any other LV you may want.
  30.  
  31. - LVGO first|next|prev|last|#LineNumber
  32.   will change the CURRENT LINE to the line specified (without moving
  33.   the actual listview visually).
  34.  
  35. - LVSEARCH string CI|CS First|Next
  36.   will search the listview for a certain string (CI=case insensitive,
  37.   CS=sensitive) and will return with the first/next lines found.
  38.   The listview's internal vars will point to the line found or "",
  39.   for no (or no more) lines
  40.  
  41. - LVMODE NUM|TXT|MULTI|DIR will change the listview's mode on the
  42.   fly. Watch out though.. strange things may happen.
  43.  
  44. - Listview loading of files is now faster.
  45.  
  46. - You can now use the ARROW buttons to move a listview. You must NOT
  47.   have declared a "xONKEY #R" command for this to happen. G4C will
  48.   itself decide which LV to move (in a totally intuitive way). You
  49.   can use up/down or shift up/down (for top/bottom) or control up/down
  50.   for fast scrolling, or left/right or shift/control left/right. 
  51.  
  52.  
  53. ************ IMAGES :
  54. --------------------------------
  55.  
  56. - Now Images can be used, via the datatypes.library (OS V39+ only)
  57.   Images are handled differently from icons, so that memory is saved.
  58.   You first load an image and give it a "Alias" (i.e. any name you want,
  59.   to which you can thereafter refer). Then you can use it in many guis,
  60.   as a background or as an Image, without having to load an other copy
  61.   of it. When you're done, you unload it..
  62.  
  63.   Image commands :
  64.  
  65.   o LoadImage ImageFile Alias ScreenName|NoRemap
  66.     will load the ImageFile, call it the Alias you gave and if you give
  67.     a screen name, the image will be remaped to that screen's colors.
  68.     If "NoRemap" is given, the image will not be remaped.
  69.  
  70.   o UnloadImage Alias - will unload that image
  71.  
  72.   o WinBackground IMAGE Alias 0 
  73.     will use the (already loaded) image and tile it to the window's 
  74.     background.
  75.  
  76.   o IMAGE Left Top Alias
  77.     will place the (already loaded) picture at the position specified.
  78.     L T of -1 means center in window.
  79.  
  80.   o ChangeImage GuiFile GadID Left Top Alias
  81.     will change the specified picture, to the "Alias" named picture
  82.     which must have already been loaded. L T of -1 means position unchanged.
  83.  
  84.   IMPORTANT !!!
  85.  
  86.   O ICON L T IconName - is now used (instead of IMAGE) for displaying a
  87.     non-clickable icon (sorry about any changes you have to make..)
  88.  
  89.  
  90. *********** NEW GADGETS/EVENTS :
  91. --------------------------------
  92.  
  93. - xAREA L T W H COMP|BOX|NONE
  94.   is a area hit gadget, like an invisible Button. Nothing will be
  95.   shown unless the gadget is hit, whereupon it will COMPlement the
  96.   area, or draw a BOX around it, or leave it alone (NONE).
  97.  
  98. - xPALETTE L T W H
  99.   will draw a palette gadget from which you can choose colors.
  100.   Every time a color is selected, the palette will "happen" and the
  101.   internal variables COLOR.R, COLOR.G, COLOR.B, COLOR.NUM, COLOR.TOTAL
  102.   will contain the R G B values, the color number and the total number
  103.   of colors. The number of colors is taken from the screen that the
  104.   window with the palette gadget will open on.
  105.   You can update a palette by choosing an other color :
  106.   > update GuiName gadID NewColorNumber
  107.   Look at the palette.gc gui to see an example 
  108.  
  109. - GAUGE L T W H IN|OUT BUTTON|RIDGE|ICONDROP APEN BPEN PERCENT
  110.   will draw a gauge which you can give a gadid to and thereafter update
  111.   as you need. The arguments are the same as for a BOX excpept for
  112.   APEN = the number of the foreground color, BPEN = background color
  113.   PERCENT = the starting percentage.
  114.  
  115.  
  116. *********** OTHER CHANGES :
  117. ---------------------------
  118.  
  119. - Also added : ELSEIF and ELSEIFEXISTS
  120.   which act the same as a new if within an if construct and can also 
  121.   deal with AND/OR etc constructs.
  122.  
  123. - Also added : OR, AND, ORIFEXISTS, ANDIFEXISTS
  124.   which take the same arguments as the respective IF and IFEXISTS 
  125.   statements and which *MUST* follow immediately after an IF or IFEXISTS
  126.   or an ELSEIF or ELSEIFEXISTS. 
  127.  
  128.   AND and OR also work with the WHILE statement.
  129.  
  130.   The above commands allow for some really tricky logical sequences, 
  131.   so be sure you have it right. Use the DEBUG option to see how they work.
  132.  
  133. - Added disk information (sizes etc) in the device list of the listviews.
  134.   Disk Errors or validation will also be shown (if they happen).
  135.  
  136. - Made the following change to env: Variable notation :
  137.   .MyVar denotes an env: variable called .MyVar (as you knew)
  138.   ..MyVar denotes an env: variable called MyVar (new)
  139.   i.e. a double full stop now denotes an env:variable *without* the
  140.        starting full stop.
  141.   This allows you to set/read "normal" env variables also.
  142.  
  143. - The COPY command is now smarter. It will understand if you give a
  144.   file name (instead of a dir) as the destination and create or overwrite
  145.   the destination file. In short you can use it as 'copy as'.
  146.   This is *not* the case with ACTION or LVACTION.
  147.  
  148. - CALCVAR ResultVar  Argument operator Argument
  149.   will provide some means of calculating. The Arguments *must* be (or
  150.   evaluate into) numbers and the result of the calculation will go into 
  151.   ResultVar.  All calculation are *Integer* only! 
  152.   As with SetVar, you can also do this which means the same thing :
  153.   ResultVar == Argument operator Argument  (i.e. MyVar == 2 * 3)
  154.   Operators are : + - * / also % (modulus) and ^ (to the power of)
  155.  
  156. - VARPATH VariableSearchPath   (Global Command)
  157.   introduces the use of PRIVATE VARIABLES in Gui4Cli. This command
  158.   is for defining paths for setting/searching private variables.
  159.   With this, the variable system has changed dramatically and it is now 
  160.   better and faster. Read the variable section in the guide for more.
  161.  
  162. - The INTERNAL VARIABLES have been rewritten completely, and there
  163.   are now many more of them - look at the guide.
  164.  
  165. - INFO GUI|GADGET|PALETTE|IMAGE Guiname|Guiname/GadID|ImageAlias
  166.   will choose an other GUI (and thereby it's window and screen) or
  167.   GADGET, PALETTE or IMAGE. After this command is issued, the respective 
  168.   internal variables will show you the information for the new item
  169.   chosen.
  170.  
  171. - PARSEVAR Variable
  172.   is a command that will take a variable and split it up into arguments
  173.   (words or quoted strings), returning them as internal variables.
  174.   Note - the ; character ends the line (like in G4C)
  175.  
  176. - A new form of DEBUG is available now. The old one still exists.
  177.   The new one can be started/stopped at any time, with "Set DEBUG ON" 
  178.   (or off), without having to start up G4C in debug mode. The new
  179.   one will show you cryptic statements instead of KeyWords and Opera-
  180.   tors, but is otherwise same. 
  181.  
  182. - Also, if you press any key while in debug mode you'll get it's 
  183.   Code & Qualifier values.
  184.  
  185. - xONKEY has now 2 new choices :
  186.   xONKEY #R  - means any raw key pressed
  187.   xONKEY #V  - means any vanilla key (apart from CONTROL keys).
  188.   Raw keys are the arrows, help & function keys - all others are
  189.   called "Vanilla" keys (God knows why..)
  190.   The internal vars $$RAWKEY.CODE, $$RAWKEY.QUAL, $$VANKEY.CODE
  191.   $$VANKEY.QUAL, $$VANKEY.LETTER, will contain the relevant key codes
  192.   and qualifiers (qualifiers are the shift, alt etc keys).
  193.  
  194. - Added \#number to command line parsing - allows to take control of
  195.   outputing stuff to the console & printer. 
  196.   See the guide at: "Important topics/Constructing command lines"
  197.  
  198. - Added new ACTION/LVACTION CLI command which will execute a command
  199.   line recursively through dirs&subdirs substituting the $$FILE
  200.   internal var in the command line given, with the file name.
  201.  
  202. - SETGAD will now also take a range of gadgets to act on.
  203.   SetGad MyGui 1/15 OFF - for example will set gadgets 1 to 15 off.
  204.  
  205. - Added Event xLVHOOK which is for Multi and Dir LV's and will
  206.   "happen" whenever an item on the LV is clicked on once.
  207.  
  208.  
  209. *********** Bug Fixes :
  210. -------------------------------
  211.  
  212. - Fixed listview reading of binary files. Now the whole file is read.
  213.  
  214. - Fixed H= operator # wildcard to recognise \n,\r,\t as text characters.
  215.  
  216. - Changed c:Gui and it will now launch Gui4Cli *with* your default paths
  217.   even if started up from the wb.
  218.  
  219. - Fixed centering of gadgets using -1 -1 for left top (hopefully..)
  220.  
  221. - EZReq will now use the calling gui's name as its title and not use the 
  222.   gui's window title as it did before.
  223.  
  224. - Now if a window tries to open in a minimized size, it will be enlarged.
  225.  
  226. - Fixed multiselect lv handling to recognise a double-click only when
  227.   the user double-clicks the LV same line.
  228.  
  229. - Fixed the BUFFERS=buffersize CLI argument. It actually works now..
  230.  
  231. - Fixed window resizing with the GadChange command.
  232.  
  233.